home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / laston11.zip / LASTON.DOC < prev    next >
Text File  |  1990-10-23  |  4KB  |  114 lines
  1.  
  2.                                   LASTON
  3.                          RBBS Callers File Lister
  4.                                   v1.10
  5.                                 10-23-90
  6.                               by Tom Collins
  7.  
  8. |    Changes
  9. |    -------
  10.  
  11. |    Changes between LASTON v1.10 and LASTON v1.00 are highlighted with a
  12. |    vertical bar in the left column.
  13.  
  14.      What
  15.      ----
  16.  
  17.      LASTON is a small utility that will read your callers file and create
  18.      a bulletin containing the last several callers to your BBS.  Text,
  19.      ASCII, and ANSI graphics versions are created, and the number of
  20.      callers listed and the callers file name can be customized by the
  21. |    user.  In addition, the display colors for the ANSI output file are
  22. |    configurable, and users can be "excluded" from the output list.
  23.  
  24.      Using it
  25.      --------
  26.  
  27. |    Using LASTON is pretty annoying:
  28.  
  29. |       LASTON <Callers> [/NCx] [/Xn] [/DD] [/FCx] [/TCx] [/UCx] [/CCx] [/DCx]
  30.  
  31. |    The /NC parameter, if used, tells LASTON how many previous callers
  32. |    to list (1 <= x <= 25).  The callers file name must be supplied.
  33.  
  34. |    The /X parameter gives LASTON the name of someone to eXclude from the
  35. |    list.  Use an underline to designate a space in a user's name, i.e.
  36. |    /XTom_Collins.  Case (upper or lower) is unimportant.
  37.  
  38. |    Use /DD to tell LASTON to display duplicate successive callers.  If,
  39. |    for example, Joe Blow calls five times in a row, and /DD is specified,
  40. |    Joe will be listed in the output files five times.  If no /DD is used,
  41. |    Joe will only show up once.  This is the default.
  42.  
  43. |    The /FC, /TC, /UC, /CC and /DC parameters set the ANSI file output
  44. |    colors.  The string specified after the /xC is bracketed with ESC [ at
  45. |    the beginning, and an m at the end to form an ANSI color string.  So,
  46. |    to set a frame color of bright yellow, you'd put /FC1;33 to generate
  47. |    .  The colors are:
  48.  
  49. |       /FC - color of the Frame around the displayed users.
  50. |       /TC - Title color.  The "The last 10 callers were..." line.
  51. |       /UC - User's name color.
  52. |       /CC - color of the user's City and state.
  53. |       /DC - color of the user's Date and time on.
  54.  
  55. |    To obtain the ANSI color equivalents, consult your DOS manual.
  56.  
  57.      Running LASTON with no parameters displays a help screen.
  58.  
  59. |    The '/' parameters can be in any order.
  60.  
  61.      LASTON will generate three output files, called LASTON, LASTONG, and
  62.      LASTONC.  You should copy or rename these to something that your users
  63.      can view.  On the MSFA BBS, we copy them to the PRELOG file, though
  64.      it could be just as easily appended to your WELCOME file(s).
  65.  
  66.      Examples
  67.      --------
  68.  
  69.      1.  Display the last 5 callers.
  70.  
  71.          LASTON callers
  72.  
  73.      2.  Display the last 10 callers, and make the frame bright blue.
  74.  
  75.          LASTON callers /NC10 /FC1;34
  76.  
  77.      3.  Display the last 20 callers, and display the same user multiple
  78.          times if he/she called multiple times in a row.
  79.  
  80.          LASTON c:\rbbs\callers /DD /NC20
  81.  
  82.      4.  Display the last 5 callers, except when Tom Collins calls.
  83.  
  84.          LASTON callers /XTom_COLLIns
  85.  
  86.      Latest Version
  87.      --------------
  88.  
  89.      The latest version of LASTON is always available on the MSFA BBS
  90.      (301-536-1935, FidoNet 1:261/1047) for P)ersonal download or file
  91.      request.
  92.  
  93.      Bugs
  94.      ----
  95.  
  96.      LASTON has no bugs.  However, if you find that LASTON needs an
  97.      "enhancement," feel free to fix it yourself and send me the change.
  98.  
  99.      Source Code
  100.      -----------
  101.  
  102.      The source code, written in TurboC, is included.
  103.  
  104.      Guarantees
  105.      ----------
  106.  
  107.      LASTON will never crash your system or delete or overwrite files.
  108.      Usually.
  109.  
  110.      Good Luck!
  111.  
  112.      -- Tom Collins
  113.  
  114.